Qu'est ce qu'une Action ?
Les "Actions" sont des raccourcis qui servent à l'utilisateur final pour générer automatiquement du contenu à l'intérieur de la zone de contenu d'une page
WikiNi?. Elles peuvent être utilisées facilement dans n'importe quelle page et par n'importe qui et décuplent ainsi les possibilités techniques du
WiKi,
La
ListeDesActionsWikiNi répertorie l'ensemble des Actions actuellement disponible dans la version stable de
WikiNi?.
Par exemple sur ce site la page
DerniersChangements contient l'
ActionRecentChanges qui affiche la liste des pages modifiées récemment. Vous pouvez aller voir la page et l'éditer pour observer comment {{RecentChanges}} est utilisé. N'hésitez pas à vous entraîner sur le
BacASable !
Comment on s'en sert ?
Une Action se met en oeuvre très simplement, en éditant une page et en plaçant n'importe où dans le texte le nom de l'action à l'intérieur d'une paire d'accolades doubles.
La syntaxe pour utiliser une Action est toujours la même :
{{nomdelaction param1="valeur1" param2="valeur2"}}
Le résultat éventuel s'affiche alors à l'endroit où elle a été appelée.
Certaines Actions peuvent accepter des paramètres, permettant ainsi de modifier légèrement leur comportement.
Les valeurs des paramètres sont toujours entre guillemets.
Les Actions s'utilisent donc comme n'importe quel autre contenu :
- On peut utiliser plusieurs Actions par page.
- On peut utiliser la même Action dans plusieurs pages différentes.
- On peut utiliser la même Action plusieurs fois dans la même page.
Comment ça marche ?
Techniquement lorsque le formateur
WikiNi? qui traduit le texte avec les balises
WikiNi? en HTML rencontre la balise {{ ..... }} il appelle la méthode Action() de l'objet $wiki. Cette méthode récupère les paramètres de l'action puis inclus le code de l'action dans le code php courant pour l'exécuter. Le code de l'Action devient donc une partie du code de la classe Wiki et peut donc accéder à ses méthodes en utilisant la variable $this.
J'en veux encore !
En réalité les Actions sont des sortes de macros ou plug-in dont la fabrication est à la portée d'un programmeur débutant. Si vous voulez essayer, consultez les règles pour
EcrireUneAction? et n'oubliez pas d'inscrire votre contribution dans la liste des
ActionsEnCoursDeDiscussion? !
Si vous avez une remarque ou une idée sur les Actions, vous pouvez également participer aux
DiscussionsSurLesActions?
En résumé :